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PRODUCT SPECIFICATION 


CHANGES FOR THE MARK VIII. 0 RELEASE 


Added new condition to the use of SYSTEM/LOAD. DUMP. 

Changed <tape name> to <tape label>. 

Deleted ADD from the LO command . 

Changed ADD to AD. 

Reworded section DISK. 

Changed definition for SENSE SWITCH 2. 

Changed Error #5 from "A/B/C BAD LOAD..." to 
"a/B/C NOT LOADED ...’'. 


‘Added Error #6 3 "A/B/C NOT DUMPED ... ‘NOT ON DISK". 
Added Error #7 : "A/B/C NOT DUMPED ... LOCKED OUT". 
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GENERAL DESCRIPIION 


SYSTEM/LOAD.OUMP is an MCP utility used to copy a file or group 
of files froe a tibrary tape to disk or from disk to tape. It is 
agnitiated only by a controt sessage fron the SPQ or card reader 
or by ZIP eessagese It creates a singte tibrary tape on a 
disk-to-tape copy and generates a tape directory which becomes 
the first file on the tape. | 


Related utility oroaraas that 


also do file-copyings but with 
different characteristics>s are: : 


Any media to any media Csingie file copy) « « « « OMPALL a he 
Disk to disk Caulti-file copy). « « « ««*« «ee « OISK/COPY or 

: SYSTEM/DISK.DUMP 
Floppy disk « « © «© © © © © © © © © 0 8 wo et ew tl lw OISKETTESCOPY 
LOAD-OUMP tape to single or multiple tapes. « .« « SYCOPY 
Verification of copy by SYSTEM/LOAD.~-DUMP.{ « « « « CHECK/LOAD.DUMP 
Copy and eerge nonwlibrary tapes << « 2 « «© « « « FAPECOPY | 


The library tapes and disk files created are unique to the 
BL800/81700 and are not coapatible with other Burroughs systems. 


SYSTEM/LOAD.DUMP is not designed to: 
- toad or duap aultipack files. 
- load or duap files on to floppy disk 
- copy disk-te-disk or tape~to-tape | 
- file-equate disk or tape to other devices 
- produce multiple copies of library tapes 


RELATED DOCUMENTATION 


Naae Nuaber 
B1800/681700 Software Operational Guide | 10687 31 
81600/81700 “CP If —  PeSe «62212 5462 

~6©81800/B81700 SYSTEM/DOISK.D0UMP PeSe 2212 5496 
61800/81700 DISK COPY PeSe 2212 5066 
81800/81700 SYCOPY PS. 2212 5199 

—BL800/B81700 DMPALL PeSe 2212 5115 

 BLS8OO/B1700 TAPECOPY P.Se 2219 
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QPERATION 


OPERAJING ENVIRONMENT 


SYSTEM/LOAD.-DUMP wilf cun on a Bi700 or B1800 with MCP II and 
tape and disk hardware. If the semory size exceeds 64K» the 


program will utitize larger 1/0 buffers and therefore mininize 


QPERATING INSTRUCTIONS 


One control vsessage will initiate the oprograa and provide ait 
necessary data. Since the variations are many» the syntax of the 
statesent is shown in SNF version. 


<LOAD-DUNP st ateaent> s3:= <head> <file tist>; 
NOTES Semicoton is required 
except on SPO input. 


<head> | | 33= <dusp> <tape Label> 
. 4 <load> <tape Label> 


<tape tabel> | | 33= <tape singte> 1 <tape single> 
rd cree BENgES? 


<tape single> 332 <identifier> 


{ "“<any strings blanks permitted>" 


<duap> 33= <du> <from where> T0 
<du> 22= DU § DUMP | UN § UNLOAD 
<froa uhere> | gs <enull string> 
1 FROM <disk Label> 

errr. | | s3=  <fo> <to heres FROM 
<io> 7 | 332 LO # LOAD @ AD 

<to where> | 23s <nult string> 

| {1 T0 <disk tabet> 

<disk labet> — | t3=  <tape singte> 


<file list> | 33= <file name> | 
| 1 <file name> <file list> 
i <file name> » <file list> 


<file name> | st= <single> § <single> / = 
| : | 1 <single> / <sincle> 
1 =/= 


ene 
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<singte> 33> <a string of fener than 11 


non blank characters> 
i “<a string of fewer than 1! 
characters» blanks peraitted>* 


The statement may be expressed in quasi~COBOL metalanguages where 
the symbols are explained as fatltlows: 


meaning “0 or 1 occurrence of" 

Cis meaning “1 of n occurrencess separated by commas or blanks* 

(} _ meaning *one of the enclosed choices” 

AD | 

LOC AD! CTO disk~t abel] FROM single-nane(l/single-nanme] 
| taperlabel singte-nane/s= | 

UNCLOAD) | | =f= 


DUEMP } CFROM disk-iabeti TO 


Iaplications of the Syntax? 


The forauiation of a LOAD-DUMP message follows a few simple 
rules. The relation is always disk firsts then tape. That iS» 
the disk nase must occur first in the sessage. If the default of 
systen disk is used» the sessage is still phrased as if the disk 
reference occurred first. 


No Default | | Default 


LOAD T0 DISK FROM TAPE or LOAD FROM TAPE 
AD TO OISK FROM TAPE or AD FROM TAPE 
DUMP FROM DISK TO TAPE or DUMP TO TAPE 
UNLOAD FROM OISK TO TAPE or UNLOAD TO TAPE 


Semantics: 


Although the possibilities of results are many» onty four actions 
are possible. 


LOAD This will Load specified files or a specified group of 
_ files from tape to disk. Single files may be specified 
or families of files on the tape may be specified as 
shown below: | 


“aultifite-t0/=* will Load a family of files 
“sf=" wild Lead ali files 


AD | AD és simifar to LOAD except that each specified file. 
is loaded onty if it was not foraerty on the disk. 


DUMP This message creates a LOAD.DUMP tape with the files 7 
copied from disk in the order requested. If no disk 
fabel is provided»s the capy is done from the systen 


| : + * 23 
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| disk. The pack-id is not alloned in che file section 


of the DUMP message. 


UNLOAD UNLOAD creates a LOAD-DUMP tape in the sane manner as 
OUNP>» except that the copied fiies are afterwards 
removed from the disk. | | 


EXTERNAL MEDIA EQRMAT 
DIS 
The disk files to be loaded or duaped may not be aulti-pack 


files. Additionally» pseudo decks are changed to data files when 
they are duaped and remain such with subsequent loads or dumps. | 


‘The disk file headers aust be consistent and as defined betow: 


FHeAREASCTR < FHe AREASeROQST 
AUL FH.AREA.ADDRESS*es should be zeros beyond the one 
specified by FHeAREA-CTR. | | 


‘Coneeurency is not checked by SYSTEM/LOAD. DUMP prior to Release 
620. | : 


TAPE 


The default format is an ANSI-labeled» autti-files aulti-reet 


tape. The first file on the tape is a directory created by 


SYSTEM/LOAD.DUMP of all the files on the tapes tisted in order. 
This directory will bear the same name as the tape-label in the 
LOAD.DUMP statement. The naming of the rest of the files is 
relational. If the tape Label is AAAA/BBBB or AAAA» then the 
files will bear the ANST label AAAA/F000001>s AAAA/FO000002> etc. 
The name of the disk from uhich the res were copied does not 


appear anywhere on the tape. 


The directory file is aade up of (nel) ecards a f 20 bytes eachs 


where n = the total nuaber of cesmaining files on the tape. The. 
first record has the value “I1I.4 DUMP" while the rest are cau 


| character file names as copied fros disk. 


Absent areas on a disk file witt not be dusped to tapes however» 
incoaplete areas are copied in their entirety because the 


end-af-file pointer is not utilized. 


QPERATING SUGGESTIONS 


7 are | er 2, 
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BUEEER SIZE | | - 
The speed of execution of SYSTEM/LOAD.DUMP is directly related to 


genory size and the tevel of MCP release. The record size is. 
always 180 bytes» but the buffer size is determined by the MCP. 


Prior to 6.0 releases buffer size is chosen to be an arithsetic 


divisor of the area size» so that for files whose disk area size 
¥3 a prise number» the prograa is forced to use one sector per 


block. This condition results in a bottleneck of disk I/0*%s. 
The 6.0 MCP is not constrained by this situation. 
SENSE SHIICH 0° 


This switch controts redundancy checking by SYSTEM/LOAD.DUHP. 
Noreailys it is set to OFF» uhich means that the progras does not 


check for redundancy» either as inctusion or as duptication. 


Error messages will be printed if there is inclusion or 
duplication and the user is responsible for deteraining the 
validity of such sessages. The prograsn» in generals» will run 
faster when the switch is off. | | 


If the user wishes to have the progras check for inclusion and 


duplications a sodify sessage must be entered from the SPO as 


follows: | | | 
MO SYSTEM/LOAD.DUNP SH 0 1 


With the switch ON» no spurtous $P0 messages wilt be generated» 
but frun-tise may be someuhat tonger. The advantage is that no 


file wilt be toaded or dusped more than once. 


EXAMPLES O£ SENSE SMLICH 9 OEE 


LOa0 


1. Inclusion 
LOAD FROM TAPE A Mes Xo XA 


Both x and KJA are included in X/=» nouewers the progras does 
not check for this. If there are files with the cenit ynaee 
X» the prograa wilt toad all of thea as directed by X/=. It 
will then generate two error nessages. — - 


X NOT LOADED -- NOT ON TAPE 

X/A NOT LOADED -- NOT ON TAPE 

These files say or may not be on the tapes but if they are» 
they have been loaded. If none of the files are on the eaoes, 
three error messages will appear on the SPO. | 


X/= NOT pene =e not ON TAPE 
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X NOT LOADED -~ NOT ON TAPE 
XJA NOT LOADED -- NOT ON TAPE 


Duplication 
LOAD FROM TAPEW~A X X 


In this statements the program is instructed to load file Xx 
twice. If there are two copies of X on TAPE. A» 
SYSTEM/LOAD-DUMP will Load both of thes and no error messages 
will be generated. If one copy of X is on the taper that 
copy will be toaded and the following error message wilt be 
printed. 


X NOT LOADED ~-NOT ON TAPE 


If the file is not on TAPESA at alt» the above error sessage 


OUKE 


The 
the 
be d 


DUMP 


wiit 
x NO 


if x 


‘This 
itse 


is printed once. 

If a tape has n copies of a fife and the instruction its: 
LOAD FROM TAPE.A X XX soe X (X occurring nt w tises)> 
then X watt be loaded ona removed n times and the message 
X NOT LOADED “NOT ON TAPE 


widl be displayed Once. 


sage file say te duaped more than once. If the user requests 
duap of a file which is not on disks the earror sessages will 
uplicated. Thus» : 

TG TAPEeA Xe Xo X/= 

generate two identical anessages: 

T DUMPED ~-NOT ON DISK 

does not exist or no file exists with the name X/«xee. 


SENSE SWITCH 1 


sense suitch should be set to zero» unless SYSTEM/LOAD« DUMP 
Lf needs to ~e eqpussrer | f 4 «se 
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SENSE SWITCH 2 


This sense switch is no longer used beginning with release 7.0. 


OPERATING PRECAUTIONS 


UNSLGAD 


Care shoutd be taken when using the UNLOAD statement. Since the 
files are deieted froa cisk iamediately after being written to 


tapes everything is lost if the tape generated is unusable. A 
safer method is to do a OUMPs run CHECK/LOAD.DUMP to insure a 
good tape and then remove the disk files by entering an “RE” 


message from the SPO. 


EXECUTE 


SYSTEM/LOAD.OUMP should be initiated onty by a LOAD.DUMP 
statement. The coamand "EX SYSTEM/LOAD.DUMP® witt generate a job 


which cannot run to coaptetion due to the absence of a 


“PARAMETERS” file. 


BAQ HEADERS 
The progras does not check the validity of disk file headers. 


They may be inconsistent or cogptetely faulty. It is the users 
responsibility to deternine this. 


MANUAL TAPE REWIND 


If a tape is manuatly rewound or taken off-line white it is being 


used by SYSTEM/LOAD.DUMP> the job wilt probably not terminate 
correctly even when the tape is put back on-tine. 


EILE EQUATES 


File equating of the tape and disk files to other hardware types 


of peripherats is possible but should not be attempted. 
PROGRAM ABORTION —_ 
If SYSTEM/LOAD.DUMP aborts during a DUMP» all files on the tape 


are good up to the error point. It should be noted» however» 
that the file directory will have a list of alt files specified 


in the LOAD.DUMP stateraent and sone of these may not be an the 


tape. This will cause an 1/0 error in future LOADs if the tape 
is read past this point. | 


If a OS-message is input to the MCP uhite the tape is in a 


 aultifile search during a LOAD» the SPO may not a untit : 


tapemark has been reached. 
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ERROR HESSAGES 


MCP-GENERAIED MESSAGES 


The most common message is (Cin COBOL-style meta-syntax): 


"A/B/C NOT DUMPED <= NOT ON DISK" 
LOADED 


The message may be spurious. 


"ERROR WHILE LOOKING FOR PACK ID FOR COAD.DUMP = POSSIBLY 


INVALIO *="." 


MCP expects the disk to be sounted when the LOAD.DUMP 
statement is received. 


" LOAD ae. 
DUMP =«-HESSAGE REQUIRES “TO™ PRECEDING THE TAPE NAME". 
AD "FROM" a. 

UNLOAD 


This means that the LOAD.DUMP statement has a syntax error. 
"TO° or *FROM* ease present before the tape nase. 


"TAPE NAME MISSING FOR LOAD. OURP™. 
This is displayed if there are no fite nases nor a tape name. 


“DANGLING SLASH FOR TAPE NAME IN LOAD.DUNP MESS". 


Something such as "LOAD FROM AS FILE.1e FILE.2* etc.” was 


specified. It. is aosyntax error. 
“LOAD-DUNP NSG ERROR - EXTRA St ASH IN TAPE NANE™. 


This syntax error nust have been something Like "LOAD FROM 
A/B/C FILEste.-* of “LOAd FROM ASB/S FILE~1.0.%- 


LOAD 
“FILES WERE NOT SPECIFIED TO DUMP =~ NOTHING DONE". 
7 AD | 
UNL OAD 


Up to and including the tape nase» there has. ‘nest no error, 
ponevere no files were specified in the statement. 
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“LOAD.DUNP MSG ERROR ~~ PACK.ID “PACK.1% SPECIFIED IN FILE 
NAME". : | | 


This is a common syntax error. The pack name was included in 
the file name» e.g. | | | 


DUMP TO TAPE.12 PACKL/SA/B 
The correct statement would be: 
DUMP FROM PACK.121 TO TAPE-1 A/B 


A LOAD.DUMP tape generated by a DUMP staterment and whose job 
was aborted say not have all the files as specified in the 
tape directory. If this partial tape is loaded to disk» the. 
following message may appear: 


“MIX ERROR ON END LABEL.j RSLTDESC = a0000A00". 
" -- MTD PARITY ON LABEL READ OS OR OP". 
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“NOT A LIBRARY TAPE". 
The first record in the first file on the tape does not 
contain the characters "fFII.4 DOUMNP”. This message sould 
appear if the request were for a LOAD. _ 
“A/B/C NOT LOADED --NOT ON TAPE*. 

"Cc" may be *=". The message indicates that the requested 
file was not on the tape» and therefore» was not loaded to 
disk. The sessage aay be spurious and/or aisteadings if Sk 90 
= 0. | | 

"A/B/C HAS INCONSISTENT FILE HEADER» WATCH OUT". 


This is a warning and say occur in a LOAD or a DUMP. Cumping 
or Loading of such a file say hang a pre~6.0 Release MCP. 


"A/B/C NOT DUMPED --MULTI-PACK FILE”. 
It is not possible toa duap a multipack file. 


“A/B/C NOT LOADED 3 <integeri> TAPE ERRS» <integer2> DISK. 
ERRS* | : 


This error sessage will be displayed after possible sessages 
from the NCP reporting some nonmrecoverable disk or tape 1/0 
errorse | 

"A/B/C ‘NOT DUMPED -“NOT ON DISK* 


The message indicates that the requested fite uas not on the 
disks and therefore net dusped to the tape. 


“A/B/C NOT OUMPED -“LOCKED OUT" 


The requested file was on disks but “as locked out by another 
programe 


= | | xe! 
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